Summary
Inserts an image in a presentation template or in another Content Studio document.
This component writes an image element to the output stream with an optional link attribute. The implementer should be aware of that some of the properties are invalid in strict doc types and will generate an error if used. See the Parameter section for more details.
Category | AS EPT |
Version | 1.1 |
Complies with Xhtml 1.0 / 1.1 rules | Yes |
Supported server programming languages | C# Visual Basic.NET |
Output content type | inline |
When to use
This component is typically used for including an image in a Content Studio document and particulary in an EPT presentation template.
Programming interface
Parameters
- EPT image field name
- A value that defines an EPT field that contains the Url to the image to show. This value is ignored if the Static image name parameter is specified.
- Static image name
- A value that defines the Url of the image to insert. Omit this parameter if the "EPT image field name" should be used.
- ImageAlt
- A value that defines an EPT field name that contains the text for the alt attribute of the generated image. This property is ignored if StaticImageAlt is specified.
- Static alt text
- A value that defines the alt attribute of the generated image. Omit this parameter if the ImageAlt parameter should be used. Since the alt-attribute is required for an image Html element, the attribute will be generated even if this value is an empty string.
- Optional custom attributes within image tag
- A value that defines attributes to be used on the image element. The value of this property must either be empty or a valid attribute syntax ex. onchange="onClick();" style="color: grey", otherwise an error will be generated.
- Image size and positioning
- Image width
- A value that defines the width attribute of the generated image.
- Image height
- A value that defines the height attribute of the generated image.
- Vertical spacing of the image
- A value that defines the vspace attribute of the generated image element.
- The use of the vspace attribute is not supported under strict doc types and will generate an error. Use CSS styling instead.
- Horisontal spacing of the image
- A value that defines the hspace attribute of the generated image element.
- The use of the hspace attribute is not supported under strict doc types and will generate an error. Use CSS styling instead..
- Image border size
- A value that defines the border attribute of the generated image element.
- The use of the border attribute is not supported under strict doc types and will generate an error. Use CSS styling instead..
- Image align
- A value that defines the align attribute of the generated image element.
- The use of the align attribute is not supported under strict doc types and will generate an error. Use CSS styling instead..
- Type of image to display
-
One of the following options:
- Use normal web image
Display the normal version of the image. If image processing is in use, the web adjusted version of the image is displayed. - Display as high resolution.
Display the high resolution version of the image. Requires image processing. - Display as thumbnail image
Display the thumbnail version of the image. Requires image processing.
- Use normal web image
- Link to alternate image behaviour
-
One of the following options:
- No link
Do not generate any link - Link to normal web image
Insert a link to the normal web version of the image - Link to high resolution image.
Insert a link to the high web version of the image. Requires image processing - Link to thumbnail image
Insert a link to the thumbnail version of the image. Requires image processing
- No link
- Optional link target
- A value that defines the target of the alternate image link generated.
Remarks